🚀 Preview deployed: https://smalruby.jp/smalruby3-editor/feature/issue-743-koshien-ruby-v2/

✅ ブラウザ DoD 確認（プレビューで実機検証, ruby_version=2）

プレビュー https://smalruby.jp/smalruby3-editor/feature/issue-743-koshien-ruby-v2/?ruby_version=2 で Playwright MCP により検証（CI も全 green）:

v2 の甲子園プログラム（リストは配列変数 $名前）を Monaco に入力 →

class Sprite1 < Smalruby3::Sprite
  when_flag_clicked do
    koshien.connect_game(name: "player1")
    koshien.calc_route(result: $最短経路)
    koshien.locate_objects(result: $地形, sq_size: 3, cent: "1:2", objects: "ABCD")
    koshien.move_to($最短経路[1])
    koshien.turn_over
  end
end

• コードタブへ切替: エラーなくブロック化（koshien_calcGoalRoute / koshien_locateObjects / connectGame / moveTo / turnOver 生成、エラーテキストなし）。
• ルビータブへ戻す: koshien.calc_route(result: $最短経路) / koshien.locate_objects(result: $地形, ...) と $名前 構文で再生成（list( なし、Monaco のエラーマーカーなし）。

→ 「v2 でエラーなくブロック化され、Ruby に戻すと $名前 構文で出力される」を確認。DoD のブラウザ項目を満たしました。

追加コミット: ゲーム接続をイベント hat 化（koshien.when_connect_game）

レビュー中に判明した重要な設計課題に対応しました。

問題: 甲子園プログラムはフラットな文列（koshien.connect_game(...) + 後続文）で生成され、v1 の Sprite.new do…end では走るが、v2 のクラス表現 class < Smalruby3::Sprite ではフラット文をスクリプトにできない。

対応: ゲーム接続を ブロックを取るイベント hat にし、AI 本体を do…end（サブスタック）に包む。

• generator: v2 は koshien.when_connect_game(name:) do … end（block.isStatement=true → scrub_ が next 連鎖を字下げ + end）。v1 はフラット維持。
• converter: koshien.when_connect_game(name:) do … end（v2）を hat + サブスタックとして解析。フラット koshien.connect_game(name:) は v1=正常 / v2=エラー（when_connect_game を使うよう促す）。
• ブロック opcode/構造は不変 → 既存 sb3 プロジェクトはそのまま読み込める。
• テスト追加: v2 when_connect_game roundtrip / v2 フラットエラー / v1 フラット維持。

ランタイム側（smalruby-koshien の src/lib）の when_connect_game 対応パッチは #743 に添付済み（検証済み）。

✅ ブラウザ DoD 確認: when_connect_game イベント hat（CI 全 green 後・更新プレビュー）

https://smalruby.jp/smalruby3-editor/feature/issue-743-koshien-ruby-v2/ を Playwright MCP で検証（#744 の CI は全 green）。

① v2: koshien.when_connect_game(name:) do … end がクラス表現に収まる形に

入力（ルビータブ）→ コードタブで変換 → 結果:

• 全ブロック生成（connectGame / getMapArea / calcGoalRoute / moveTo / turnOver）、エラーなし。
• koshien_connectGame は hat-root（topLevel=true / 親なし / サブスタックあり）= AI 本体を内包。
• ルビータブへ戻すと:

  koshien.when_connect_game(name: "player1") do
    koshien.get_map_area("0:0")
    koshien.calc_route(result: $最短経路)
    koshien.move_to($最短経路[1])
    koshien.turn_over
  end

  （本体は 2 スペース字下げ、リストは $最短経路、list( なし、エラーマーカーなし）

② v2: フラット koshien.connect_game はエラー

エラーマーカー: 「koshien.connect_game is only available in Ruby version 1. Please use koshien.when_connect_game(name: ...) do ... end instead.」

③ v1: フラット形式は従来どおり（後方互換）

ruby_version=1 で koshien.connect_game(name: "player1") + 後続文 → エラーなく変換、フラットのまま round-trip。

→ DoD のブラウザ確認項目（v2 でクラス本体に収まる / v2 フラットはエラー / v1 後方互換）をすべて満たしました。